home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 19 / Night Owl (The Best of Shareware)(NOPV 19)(1996).ISO / 007a / tgquot55.zip / TGQUOTE.DOC < prev    next >
Text File  |  1995-12-07  |  49KB  |  1,016 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.                                                                
  10.           |  TGQuote v5.5
  11.           |  Telegard Daily Quote Generator
  12.           |  
  13.           |  Copyright 1993-1995, Mark Radabaugh and Todd Hendricks.
  14.           |  All Rights Reserved.
  15.           |  
  16.           | 
  17.           |  "The most advanced quote file generator available."
  18.           |  
  19.           |  Documentation written by Todd Hendricks and Mark Radabaugh.
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28. TGQuote v5.5 - Copyright (C) 1993-1995                                      i
  29. ──────────────────────────────────────────────────────────────────────────────
  30.  
  31.                         T A B L E  O F  C O N T E N T S
  32.                         ───────────────────────────────
  33.  
  34. Warranty and Copyright Information . . . . . . . . . . . . . . . . . . . 1
  35.  
  36. Upgrading from Version 5.0 . . . . . . . . . . . . . . . . . . . . . . . 2
  37.  
  38. Introduction to TGQuote. . . . . . . . . . . . . . . . . . . . . . . . . 2
  39.  
  40. Whats new in TGQuote 5.5 . . . . . . . . . . . . . . . . . . . . . . . . 3
  41.  
  42. Configuring TGQuote. . . . . . . . . . . . . . . . . . . . . . . . . . . 5
  43.  
  44. Quote Generating System. . . . . . . . . . . . . . . . . . . . . . . . . 9
  45.  ├─ Manually Selecting a Quote . . . . . . . . . . . . . . . . . . . . . 9
  46.  ├─ Custom Layouts . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  47.  └─ Import Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
  48.  
  49. Quote Files. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
  50.  ├─ Adding Quotes to the Quote Files . . . . . . . . . . . . . . . . . . 11
  51.  ├─ Printing Quote Files . . . . . . . . . . . . . . . . . . . . . . . . 11
  52.  └─ Editing/Modifying Quotes Already in the Quote Files. . . . . . . . . 12
  53.  
  54. Adding/Modifing Extended Quote File Information. . . . . . . . . . . . . 12
  55.  
  56. Letting Users Generate Custom Quotes . . . . . . . . . . . . . . . . . . 12
  57.  
  58. Multi-Node Support . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  59.  
  60. Registering TGQuote. . . . . . . . . . . . . . . . . . . . . . . . . . . 13
  61.  
  62. Future Versions of TGQuote . . . . . . . . . . . . . . . . . . . . . . . 14
  63.  
  64. Contacting the Authors . . . . . . . . . . . . . . . . . . . . . . . . . 14
  65.  
  66. Revision History of TGQuote. . . . . . . . . . . . . . . . . . . . . . . 15
  67.  
  68. Bug Reports. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
  69.  
  70. Error Code List. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
  71.  
  72. Note From the Authors. . . . . . . . . . . . . . . . . . . . . . . . . . 19
  73.  
  74.  
  75. TGQuote v5.5 - Copyright (C) 1993-1995                                      1
  76. ──────────────────────────────────────────────────────────────────────────────
  77.  
  78.                         Warranty and Copyright Information
  79.                         ──────────────────────────────────
  80.  
  81. You are hereby granted permission to copy, distribute, and use TGQuote, as
  82. long as the following restrictions are obscrued:
  83.  
  84.         1) Distribute the program only in its original form, with all its
  85.            related files intact.  The only exception is that of converting
  86.            to a different archive format.
  87.  
  88.         2) You are permitted to modify the program's executable files for
  89.            your own personal use, provided you are a registered user of the
  90.            program, and you agree NOT to distribute the modified files.
  91.  
  92.         3) You are restricted from modifying the document files in any way.
  93.  
  94. TGQuote has no warranty, and no other responsibilities are implied.  We (the
  95. authors) assume no responsibility for damages that may have been caused by the
  96. program.  This in no way implies that the program was intended to do any 
  97. damage in any way, shape, or form.  You agree to accept any damages that the 
  98. program may cause.
  99.  
  100. TGQuote is copyrighted under the United States laws concerning copyrights of
  101. electronic media.  All rights under this law are reserved, and any violation 
  102. of this law, no matter how severe, will be prosecuted to the fullest extent of
  103. the law.
  104.  
  105. If you have registered TGQuote, you are restricted from distributing your
  106. keycode in ANY fashion, whether it be by word of mouth, message transfer, file
  107. transfer, or other means that would enable other persons to acquire the
  108. information to register TGQuote.
  109.  
  110. Failure to follow any of the restrictions will result in withdrawal of your
  111. keycode from registration, and prosecution (if applicable).
  112.  
  113.  
  114. TGQuote v5.5 - Copyright (C) 1993-1995                                      2
  115. ──────────────────────────────────────────────────────────────────────────────
  116.  
  117.                             Introduction to TGQuote
  118.                             ───────────────────────
  119.  
  120. TGQuote is a program that generates a text file containing a quote.  The
  121. program can generate a file in ANSI, or ASCII(TTY).  You can enter up to 10
  122. lines for the quote, with either 69 or 77 characters per line, depending on
  123. layout used.
  124.  
  125. If your copy of TGQuote is registered, you may access more features!  You can
  126. import an ANSI/ASCII file, create a custom layout, have TGQuote test for
  127. duplicate quotes, and even more!
  128.  
  129. TGQuote has support for ANSI, and ASCII text modes.  You can import a
  130. pre-generated file for use in either mode.  All you need in the file are some
  131. simple MCI codes.  More on the generating capabilities of TGQuote later in
  132. the document.
  133.  
  134. We as the authors wish to thank you for choosing TGQuote as your quote
  135. software of choice.  We have done our best to provide you with a well
  136. layed-out system for making common quotes (or not-so-common quotes)
  137. displayable anywhere.  Whether it be a BBS or your place of business, this is
  138. a good way to raise people's spirits or provide a laugh at a time it may be
  139. needed.
  140.  
  141.  
  142.                            Upgrading from version 5.0
  143.                            ──────────────────────────
  144.  
  145. Provided in this archive of TGQuote is a utility called CONVERT.EXE.  The
  146. upgrade to version 5.5 is extensive, and this program will convert your old
  147. configuration files, along with your old quote files.  Your v5.0 files are
  148. NOT compatible with v5.5.
  149.  
  150. To upgrade to v5.5 from v5.0 you must first delete the file called FILES.DAT
  151. from your TGQuote directory.  Next, you must convert you data and quote files
  152. to the v5.5 format by running the utility CONVERT.EXE.
  153.  
  154. MAKE A BACKUP OF *ALL* YOUR DATA AND QUOTE FILES BEFORE RUNNING ConvertQuote!
  155. THAT WAY, YOU HAVE SOMETHING TO FALL BACK ON IF SOMETHING GOES WRONG!!
  156.  
  157.  
  158. TGQuote v5.5 - Copyright (C) 1993-1995                                      3
  159. ──────────────────────────────────────────────────────────────────────────────
  160.  
  161.                            What's new in version 5.5
  162.                            ─────────────────────────
  163.  
  164. There have been so many things added to TGQuote since the release of v5.0 that
  165. we don't think we can remember them all!  What is listed here is a brief
  166. explaination of changes and new features.  If there is anything we missed, you
  167. should be able to find them later on in this document.
  168.                     
  169.         1) NEW CODE.  TGQuote v5.5 was completely re-written from the ground
  170.            up.  This was done for several reasons.  One major reason was on
  171.            most computer systems, the software didn't work correctly, or not
  172.            at all.  On all the systems tested, the new code ran flawlessly.
  173.  
  174.         2) NEW INTERFACE.  TGQuote now has a new interface, which should make
  175.            it easier to use.
  176.         
  177.         3) REVAMPED REGISTRATION SYSTEM.  The registration routines for
  178.            TGQuote have been revamped.  They now require the BBS name in the
  179.            registration.  Revamping the system fixed a couple of bugs with it,
  180.            and allowed for more flexibility.  To those who registered:  Your
  181.            old registration code *WILL NOT* work with the new version -
  182.            therefore, you will receive a new code sometime in the next couple
  183.            of weeks.  Sorry!
  184.  
  185.         4) NEW CONFIGURATION SYSTEM.  TGQuote v5.5 now was a new configuration
  186.            system.  Instead of using the clumsy QUOTE.DAT; REMOTE.DAT; and for
  187.            registered users, REGISTER.DAT, TGQuote v5.5 now has a more
  188.            logically organized QUOTE.INI file, which contains all the
  189.            configuration information.  REMOTE.CFG is still used due to the door
  190.            library we are using.  This problem will be addressed in a future
  191.            release.
  192.  
  193.         5) NEW ERROR TRAPPING ROUTINES.  TGQuote now has brand new error
  194.            trapping routines.  Whenever TGQuote encounters an error, it
  195.            generates an error code (some of which are generated by DOS), and
  196.            captures the screen to a file called ERROR.LOG.  TGQuote also
  197.            places some critical information in the file as well.
  198.  
  199.         6) FILES.DAT REMOVED.  In addition to the new configuration system,
  200.            you will no longer need your FILES.DAT file.  TGQuote will now
  201.            create a "phantom" list of your quote files, and use it instead.
  202.  
  203.         7) EXTENDED QUOTE FILE EDITOR.  You can now edit the "extended"
  204.            information in your quote files.  You can specify whether TGQuote
  205.            should use the author, or a different header, without having to
  206.            change your configuration.  This feature was available in v5.0,
  207.            but the editor wasn't there.  This will make your life A LOT
  208.            easier in editing.  *REGISTERED ONLY*
  209.  
  210.         8) FILE IMPORT REVAMPED.  The import routines have been revamped.
  211.            This was done because often the file wasn't imported correctly, and
  212.            the code took up so much room, plus it was SLOW, too.  So...  The
  213.            new routines are fast, compact, and work better.  *REGISTERED ONLY*
  214.  
  215.         9) MOVE QUOTE FEATURE.  The move quote feature has once again
  216.            returned.
  217.  
  218.  
  219. TGQuote v5.5 - Copyright (C) 1993-1995                                      4
  220. ──────────────────────────────────────────────────────────────────────────────
  221.  
  222.        10) DUPLICATE QUOTE CHECKER.  TGQuote v5.5 now has the option to check
  223.            for duplicate quotes when adding quotes to a quote file.
  224.            *REGISTERED ONLY*
  225.  
  226.        11) SETQUOTE IMPROVED.  SetQuote has been completely re-designed, and
  227.            is even its own file!  This change gave us more room in the main
  228.            executable to add more features!  The new design has been layed out
  229.            more logically, and gives you a better idea of your configuration.
  230.  
  231.        12) COMMAND-LINE QUOTE FILE SELECTION.  In some cases, TGQuote will
  232.            allow you to select the quote file from the command-line.
  233.  
  234.        13) RIP CAPABILITIES REMOVED.  TGQuote v5.5 doesn't support RIP
  235.            capabilities.  We didn't add RIP to the new code because we thought
  236.            it would take too much time to add them with the features we
  237.            wanted, and we were already EXTREMELY LATE with this release to
  238.            begin with.  If you want RIP capabilities added to the next
  239.            version, just drop us a note in E-MAIL.
  240.  
  241.        14) NO LAYOUT BORDER.  TGQuote now gives you the option use a layout
  242.            border or not.
  243.  
  244.        15) NEW QUOTE LENGTH.  TGQuote v5.5 now incorporates two line lengths
  245.            for quotes.  If you're using no border, then the length is up to 77
  246.            characters per line, otherwise, it's the standard 69 characters per
  247.            line.
  248.  
  249.        16) TEXT PROCESSOR.  You can now use special flags in the header field
  250.            that will make TGQuote do special things to the header.  For
  251.            example, you can have TGQuote place the quote number in the header.
  252.  
  253.        17) PAUSE STRING.  For those systems that don't have a pause string
  254.            capability (or don't use one), TGQuote can now print a string of
  255.            text before passing the pause command.
  256.  
  257.  
  258. TGQuote v5.5 - Copyright (C) 1993-1995                                      5
  259. ──────────────────────────────────────────────────────────────────────────────
  260.  
  261.                               Configuring TGQuote
  262.                               ───────────────────
  263.  
  264. To configure TGQuote, use the program called SetQuote.  To access this file,
  265. type SETQUOTE at the DOS prompt.  This program is designed to ease the setup
  266. process for TGQuote.  SetQuote is menu driven, making it easy to use.  Each
  267. option is listed, with explanations on it's use.
  268.  
  269.                                 -- Main Menu --
  270.  
  271. Upon execution of SetQuote, you'll enter the main menu.  The features of
  272. TGQuote have been arranged in a logical order, of only seven options.  Listed
  273. below are the options contained in the main menu, with a brief discription of
  274. each.  You can select an option by using the arrow keys.
  275.  
  276.   -- SETUP TGQuote - Allows you to configure the main part of the program.
  277.   
  278.   -- SETUP RemoteQuote - Allows you change the RemoteQuote door configuration
  279.      information.
  280.  
  281.   -- SETUP REMOTE.CFG - Allows you to configure the REMOTE.CFG file.  This
  282.      option contains options for the drop file location, drop file type,
  283.      along with the BBS and SysOp names.
  284.   
  285.   -- CONFIG PRINTER - Allows you to configure the printer port, top and
  286.      bottom margins, lines per page, and whether your printer supports the
  287.      IBM extended character set.
  288.      
  289.   -- MISCELLANEOUS - Allows you to setup options like the pause information,
  290.      duplicate quote checker options, and, for registered users, whether to
  291.      show the registration information on certain items created by TGQuote.
  292.  
  293.   -- RESET TO DEFAULTS - This option resets to the internal default
  294.      configuration settings.
  295.  
  296.   -- EXIT - Allows you to return to DOS, and save any changes to your
  297.      configuration.
  298.  
  299. Listed over the next few pages are more in-depth explainations of each
  300. option.
  301.  
  302.  
  303. TGQuote v5.5 - Copyright (C) 1993-1995                                      6
  304. ──────────────────────────────────────────────────────────────────────────────
  305.  
  306.                               -- Setup TGQuote --
  307.  
  308. You can move through the options on the screen by pressing the TAB key at any
  309. time.  To change the setting of an option, press the space bar, or enter text
  310. information.
  311.  
  312.   -- PATH - This is the path and name of the text file TGQuote will create
  313.      upon execution.  Enter this information *WITHOUT* the extension.
  314.      TGQuote will use the appropriate extension depending on the type of
  315.      file (ANSI or ASCII).
  316.  
  317.   -- HEADER - This is the header that TGQuote will use everytime it
  318.      uses a quote file that does not contain the extended quote information.
  319.  
  320.   -- USE AUTHOR - This setting instructs TGQuote to use the author when it
  321.      generates the bulletin.  This is the setting used if the quote file does
  322.      not contain the extended information.
  323.  
  324.   -- SHADOW - This setting instructs TGQuote to create a shadow behind
  325.      the quote in the bulletin.  This shadow creates a "3-D" kind of effect.
  326.  
  327.   -- SELECTION MODE - This is the mode TGQuote uses to select the quote.
  328.      Random allows TGQuote to randomly select a quote from the file.
  329.      Sequential forces TGQuote to use the next quote in the quote file; if at
  330.      end of file, TGQuote will randomly select a file, then select quote #1.
  331.  
  332.   -- CLEAR SCREEN - Tells TGQuote to put the clear screen command in the
  333.      beginning of the ANSI bulletin.
  334.  
  335.   -- PAUSE - This setting tells TGQuote to place the pause information at the
  336.      end of the bulletin.
  337.  
  338.   -- COLOR SYSTEM - Tells TGQuote if it should create an ANSI bulletin or not.
  339.  
  340.   -- LAYOUT - Tells TGQuote which border to use.  You can select no border,
  341.      which allows a 77 character line; a custom border which you can create;
  342.      import an ANSI/ASCII file; or line, box, or double line.  As an added
  343.      option, you can have TGQuote randomly select between line, box, or double
  344.      line.  All borders, including custom and import, use a 69 character line.
  345.  
  346.   -- STYLE/IMPORT INFORMATION - This option depends on the layout setting.
  347.      If you selected import, enter the import file name here.  Otherwise,
  348.      select one of five styles, or have TGQuote randomly select one.
  349.  
  350.   -- COLOR SETTINGS - Next, you can setup the colors you wish TGQuote to use
  351.      for the ANSI bulletin.  Toggle between the color fields by pressing TAB,
  352.      and change the color by pressing the space bar.  When changing the
  353.      foreground color, an "F" will appear on the field you are changing.  If
  354.      you're changing the background color, a "B" will appear.
  355.  
  356.  
  357. TGQuote v5.5 - Copyright (C) 1993-1995                                      7
  358. ──────────────────────────────────────────────────────────────────────────────
  359.  
  360.                             -- Setup RemoteQuote --
  361.  
  362. For the most part, this screen contains the RemoteQuote equivalent of the
  363. TGQuote information.  However, some options are different.  For example,
  364. the quote selection mode does not apply to RemoteQuote, so it doesn't exist
  365. on this screen.  Here is a list of different options on screen:
  366.  
  367.   -- MAX LINES - This option lets you define the number of lines you want
  368.      RemoteQuote to allow for the user, if registered.  The default is five
  369.      quote lines, and two author lines.
  370.  
  371.                             -- Setup REMOTE.CFG --
  372.  
  373. This screen allows you to setup the configuration file needed by the door
  374. library used by TGQuote for RemoteQuote.  This information is not contained in
  375. the main configuration file, QUOTE.INI.
  376.  
  377.   -- BBS NAME - This is the name of your BBS.
  378.  
  379.   -- SYSOP NAME - This is your handle on the BBS, or your real name.
  380.  
  381.   -- DROP FILE PATH - How RemoteQuote finds your door drop file.  The drop
  382.      file is very important as it contains much information about the user.
  383.  
  384.   -- DROP FILE - The drop file your BBS creates when it shells to run
  385.      RemoteQuote.  You can select one of seven: DORINFOx.DEF; DOOR.SYS;
  386.      CALLINFO.BBS; CHAIN.TXT; PCBOARD.SYS; GTUSER.BBS; and SFDOOR.DAT.
  387.  
  388.                              -- Config Printer --
  389.  
  390. This screen allows you to change the settings PrintQuote uses for your
  391. particular printer.
  392.  
  393.   -- PORT - This option lets you select between LPT1: or LPT2: as the port
  394.      your printer is connected to.
  395.  
  396.   -- EXTENDED CHARACTERS - This option tells PrintQuote to send characters
  397.      found in the IBM character set.  Some printers can't support these
  398.      characters, and this option allows you to turn this feature off.  If this
  399.      setting is off, PrintQuote will print the standard character set
  400.      equivalent.
  401.  
  402.   -- MARGINS - This sets up top and bottom margins for your printer.
  403.  
  404.   -- LINES PER PAGE - This tells PrintQuote how many lines your printer can
  405.      print on one page.
  406.  
  407.  
  408. TGQuote v5.5 - Copyright (C) 1993-1995                                      8
  409. ──────────────────────────────────────────────────────────────────────────────
  410.  
  411.                               -- Miscellaneous --
  412.  
  413. This screen allows you to change miscellaneous options used in TGQuote.
  414.  
  415.   -- PAUSE INFORMATION - This option sets the pause command to be used by your
  416.      BBS program.  You can have TGQuote print a small line of text before it
  417.      sends the pause command - useful for BBS programs that don't have the
  418.      ability to print something like "Press a key to continue..."
  419.  
  420.   -- SEARCH FOR DUPE QUOTES - You can have AddQuote search for a quote that
  421.      may have been previously entered.  This helps to keep duplicate copies
  422.      of the same quote from cluttering up your quote files.
  423.  
  424.   -- SAVE DUPE QUOTES - If you're using the duplicate quote checker, you can
  425.      also have the checker save the quote anyway, ask if you want it saved
  426.      every time it finds a duplicate quote, or never save the quote.
  427.  
  428.   -- SHOW REGISTRATION INFORMATION - For registered users, you can prevent
  429.      TGQuote from adding registration information to the bulletins, or in
  430.      RemoteQuote.
  431.  
  432.                             -- Reset to Defaults --
  433.  
  434. This option will reset the settings to the internal defaults.  This feature is
  435. useful if you need to start your configuration from scratch.
  436.  
  437.  *WARNING* - Use this option only in a worst-case scenario!  It cannot be
  438.              un-done.  *ALL* settings will be reset, and you will likely have
  439.              to update them before TGQuote will run properly!
  440.  
  441.  
  442. TGQuote v5.5 - Copyright (C) 1993-1995                                      9
  443. ──────────────────────────────────────────────────────────────────────────────
  444.  
  445.                      The Quote Generating System of TGQuote
  446.                      ──────────────────────────────────────
  447.  
  448. The quote generating system is rather unique to this copy of TGQuote.  What
  449. the system will do is select a quote from the files you have (Extension .QTS)
  450. and put it into a creative little file for display on your BBS (or whatever). 
  451. There are many things you can do with this system.
  452.  
  453. Needed are the following files:
  454.  
  455. *.QTS -
  456.  
  457.         Of course, you must have quote files in order to generate the 
  458.         bulletin.
  459.  
  460. REMOTE.CFG -
  461.  
  462.         If you plan on using the RemoteQuote feature of TGQuote, you must have
  463.         this file to define how the "door" will act.
  464.  
  465. QUOTE.INI - 
  466.  
  467.         This is the configuration file.  Note you can have a separate
  468.         configuration for both the quote generator and the RemoteQuote feature
  469.         of TGQuote.
  470.  
  471. LAYOUTS.DAT -
  472.  
  473.         This file is optional and only needed and used when TGQuote is using a
  474.         custom layout.
  475.  
  476.                           Manually Selecting a Quote
  477.                           ──────────────────────────
  478.  
  479. To manually select a quote, type QUOTE /M at the DOS prompt.  You will be
  480. prompted for the name of the quote file you want to select.  Once you have
  481. entered the filename, TGQuote will begin to display quotes from within that
  482. file.  Once the screen is full, TGQuote will prompt you for an action.  You
  483. may either select a quote (S), display the next page (N), jump to a quote (J),
  484. change the quote file (C), edit the extended quote file information (X), or
  485. quit to DOS (Q).  The default is selecting a quote.
  486.  
  487. Additionaly, if you wish to select the quote file from the command-line, you
  488. may type the filename (without extension) by using the following syntax:
  489.  
  490.         QUOTE /M:<filename>             Example - QUOTE /M:SAYINGS
  491.  
  492. In this case, TGQuote will not prompt for the quote file, and immediately
  493. begin to list the quotes in the file.
  494.  
  495.  
  496. TGQuote v5.5 - Copyright (C) 1993-1995                                     10
  497. ──────────────────────────────────────────────────────────────────────────────
  498.  
  499.                                  Custom Layouts
  500.                                  ──────────────
  501.  
  502. If TGQuote is registered, you have the ability to create custom layouts.  To
  503. create a custom layout, use the utility included with TGQuote, LAYOUT.EXE
  504.  
  505. Upon execution, Layout searches for existing layouts.  If any are found, you
  506. can select to add, delete, or edit a layout, as well as dropping to DOS.
  507.  
  508. Layout is navigated by using the arrow keys.  Simply move to the section whose
  509. character you want to change and press the ENTER key.  It will then prompt you
  510. to enter the character you wish to use.  Note that extended characters are
  511. entered by holding down the ALT key and then typing the extended code of the
  512. character on your keypad.
  513.  
  514. To quit, press Q.  Layout will prompt you to save your changes, if any.  To
  515. save your layout, press 'Y' for yes or "N" for no.
  516.  
  517. To load a different layout, press 'L'.  To reset to defaults, press 'D'.
  518.  
  519.                                 Importing Files
  520.                                 ───────────────
  521.  
  522. Importing a file into TGQuote is easy!  TGQuote will look for the import
  523. file with the name you specify.  For ANSI, the file must have a .ANS
  524. extension, and for ASCII it must have a .TXT extension.  For ANSI, you
  525. obviously need an ANSI drawing program.  TheDraw is a very popular choice, and
  526. fits the requirements nicely.  And, TGQuote must be registered.
  527.  
  528. Here are the MCI codes supported by TGQuote:
  529.  
  530.         %M      This is the HEADER code. Ie, "Today's Quote Is:"
  531.  
  532.         %Q      This is the QUOTE code.  Unlike previous versions, you no
  533.                 longer need to specify a number.  Just place the %Q code
  534.                 where ever you want a quote line placed.  TGQuote will
  535.                 automatically advance to the next quote line.
  536.  
  537.         %A      This is the AUTHOR code.  The same specifications are used
  538.                 as with the quote code.  No number needed, TGQuote will
  539.                 automatically advance to the next author line.
  540.  
  541.         %V      This is the VERSION *NUMBER* code.
  542.  
  543.         %R      This is the REGISTRATION INFORMATION code.
  544.  
  545.  
  546. TGQuote v5.5 - Copyright (C) 1993-1995                                     11
  547. ──────────────────────────────────────────────────────────────────────────────
  548.  
  549.                                    Quote Files
  550.                                    ───────────
  551.  
  552. The quote files are simple text files with special codes instructing the
  553. program how to interpret them.  We would not suggest modifying these files.
  554. We have provided special utilities to do it for you.
  555.  
  556.                         Adding Quotes to the .QTS Files
  557.                         ───────────────────────────────
  558.  
  559. To add quotes to a quote file, run the program called AddQuote.  To access
  560. this file, type QUOTE /A at the DOS prompt.  The program asks for a quote file
  561. to add to, or to create.  You may enter a quote of up to 10 lines, 77
  562. characters in each line.  You do not need quotation marks, the program does it
  563. automatically.
  564.  
  565. Using the same command-line syntax as with the manual quote selection, you may
  566. specify which quote file you want AddQuote to use or create.
  567.  
  568. When you finish entering the quote, press /S, unless you are on line 10.  You
  569. will next be prompted for the author.  Again, you need not add quotation
  570. marks.  Press <ENTER> alone to exit the author entry fields.
  571.  
  572. Next, you are prompted for verification of the information you entered.  If
  573. "No," AddQuote will return you to the beginning of the quote entry process.
  574. If "Yes," depending on your configuration, AddQuote will either scan for
  575. duplicate quotes, prompt you to scan, or just skip the scanning process
  576. completely.  TGQuote must be registered in order for the dupe checker to be
  577. active.
  578.  
  579. If AddQuote scans for duplicate quotes, and TGQuote finds any, again,
  580. depending on your configuration, AddQuote will either save them, not save
  581. them, or prompt you for permission.  If no duplicate quotes are found,
  582. AddQuote will automatically save the quote to the quote file.
  583.  
  584. Once the quote has been saved to disk, AddQuote asks if you'd like to enter
  585. another quote.  If "No," you will be returned to DOS.
  586.  
  587. You can quit to DOS at anytime during the quote entry process by typing "/Q"
  588. on a blank line.
  589.  
  590.                          Printing Out your Quote Files
  591.                          ─────────────────────────────
  592.  
  593. To print quote files (*.QTS), TGQuote must be registered.  Once registered,
  594. you can use PrintQuote by typing QUOTE /P at the DOS prompt.  You can specify
  595. the quote file to use by type QUOTE /P:<filename> at the DOS prompt.
  596. <Filename> is the name of the file without the extension.
  597.  
  598. Once the quote file has been selected, an option box appears.  This box
  599. displays number of quotes in the file, the port PrintQuote uses, the page
  600. length, and top and bottom margins.  You can also select which quote to begin
  601. with, and stop with.
  602.  
  603. Also displayed are three command buttons.  Choosing "Print," PrintQuote will
  604. output to the printer.  Choosing "Change File," allows you to change quote
  605. files, and choosing "Cancel" returns to DOS.
  606.  
  607.  
  608. TGQuote v5.5 - Copyright (C) 1993-1995                                     12
  609. ──────────────────────────────────────────────────────────────────────────────
  610.  
  611.              Editing/Modifing Quotes Already in the .QTS Files
  612.              ─────────────────────────────────────────────────
  613.  
  614. To edit a quote, you must have TGQuote registered.  Once registered, you can
  615. run EditQuote by typing QUOTE /E from the DOS prompt.  You will be prompted
  616. for a quote file.  Optionally, using the same syntax as in manual mode,
  617. specify the quote file from the command line.
  618.  
  619. Upon execution, EditQuote will look and operate much like the manual mode of
  620. TGQuote.  However, once you select a quote, you will be prompted for an
  621. action.
  622.  
  623. You may edit the quote (E), delete the quote (D), move the quote (M), or quit
  624. to DOS (Q).
  625.  
  626. Editing the quote works much like AddQuote.  Instead of blank lines for
  627. entering quotes, the quote you have selected is displayed.  You also will
  628. have the opportunity to edit the author's name and note.
  629.  
  630. When moving the quote, you are prompted for a file name to move the quote to.
  631. Upon selection, EditQuote will append the quote to the end of the destination
  632. file, and remove it from the source file.
  633.  
  634.                  Adding/Modifing Extended Quote File Information
  635.                  ───────────────────────────────────────────────
  636.  
  637. TGQuote allows you to specify a different header for a quote file than the
  638. default in QUOTE.INI.  You may also specify whether or not to display the
  639. author for the file.  To do this, you must have TGQuote registered.  You can
  640. gain access to this special editor in three areas:  EditQuote, the manual
  641. quote selection, or from the command line.  In EditQuote and manual mode,
  642. press "X" at the quote selection prompt.  From the command line, type
  643. QUOTE /X.
  644.  
  645. Upon execution, ExQuote gives you two options: 1) Edit the header, or
  646. 2) Author usage.  If the quote file has had the extended information added to
  647. it, that information will appear in the fields.  Otherwise, the default info
  648. contained in QUOTE.INI will be displayed.
  649.  
  650. Placing codes in the header field makes TGQuote change the header.  At the
  651. current time, the following codes are supported:
  652.  
  653.         %Q - Places the quote number at the location of the code.
  654.         %A - Places the first line of the author at the code location.
  655.  
  656. More codes will be added in future versions.
  657.  
  658.                     Letting Your Users Generate Custom Quotes
  659.                     ─────────────────────────────────────────
  660.  
  661. To do this, you must have RemoteQuote configured, and a REMOTE.CFG file.
  662. These are created using SetQuote.  Once both are setup, run RemoteQuote by
  663. typing QUOTE /R REMOTE.CFG.  RemoteQuote supports 7 different drop files:
  664. DORINFOx.DEF; DOOR.SYS; CALLINFO.BBS; CHAIN.TXT; PCBOARD.SYS; STUSER.BBS; and
  665. SFDOOR.DAT.  If you'ld like to run RemoteQuote in local mode and your drop
  666. file gives a baud rate other than zero (0), you can use the LOCAL command when
  667. executing RemoteQuote.  I.e. QUOTE /R REMOTE.CFG LOCAL.
  668.  
  669.  
  670. TGQuote v5.5 - Copyright (C) 1993-1995                                     13
  671. ──────────────────────────────────────────────────────────────────────────────
  672.  
  673. On the bottom of the screen, an information bar spans over two lines.  On the
  674. left of the bar, you'll see the users handle/name, and below it, their
  675. location.  To the right of this information, you'll see several other fields
  676. of information.  In the "TL" field, you'll see the amount of time left for the
  677. user; next, in the "SL" field, you see the users security level; then, you
  678. see the node number in the "NN" field; and finally, you'll see the connected
  679. baud rate in the "BR" field.
  680.  
  681. Also located on this bar, you'll see four function key options.  You may
  682. press these keys at any time to use their respected function.  By pressing
  683. "F7," you can exit RemoteQuote and return to the BBS; by pressing "F8," you
  684. can perform a DOS shell; pressing "F9," will hangup the phone, and return to
  685. the BBS; and finally, by pressing "F10," you can chat with the user.
  686.  
  687.   *WARNING* - For some reason, the door library doesn't allow a way to exit
  688.   chat without exiting the door.  Therefore, until we re-write RemoteQuote
  689.   with a different library, we strongly caution you on using chat within
  690.   RemoteQuote.  Use it only as a last resort!  Be warned!
  691.  
  692. RemoteQuote will execute, and the user can send a quote to the next user
  693. WITHOUT CORRUPTING YOUR QUOTE FILES!  RemoteQuote will execute TGQuote in
  694. normal mode, and pass the quote to it.  TGQuote will generate the quote for
  695. the user, then exit back to your BBS.
  696.  
  697.                               Multi-node support
  698.                               ──────────────────
  699.  
  700. RemoteQuote can be run in a multi-node environment.  To accomplish this task,
  701. you must create a separate REMOTE.CFG file for each node.  For example, node
  702. 1 uses REMOTE1.CFG, node 2 uses REMOTE2.CFG, etc.  The difference in the
  703. config file is the location of the drop file.  You have to create each
  704. REMOTE.CFG file separately, and rename the file from REMOTE.CFG to
  705. REMOTExx.CFG.  Here's an example of how you can execute RemoteQuote in a
  706. multi-node environment in TG: C:\BBS\QUOTE.BAT /R REMOTE~CN.CFG
  707.  
  708.                               Registering TGQuote
  709.                               ───────────────────
  710.  
  711. To register TGQuote, just follow the instructions contained in the 
  712. REGISTER.FRM file included in this archive.  The registration fee is only $10,
  713. and can be paid with either a check or money order.  Please make the check or
  714. money order payable to Mark Radabaugh.
  715.  
  716. If you register TGQuote, you will have access to all the special features of
  717. TGQuote.  We will send you a letter, which will contain your personal key and
  718. a list of features you now have access to.  This letter will also contain
  719. instructions on how to enter your key into the program.  We will send this
  720. letter to you via U.S. "snail" Mail.
  721.  
  722. If you wish, we may also be able to give you the instructions and keycode by
  723. calling your BBS.  If you wish this method, just leave a note in the
  724. REGISTER.FRM file.  This method, however, will cost an additional $1 for
  725. phone charges.
  726.  
  727.  
  728. TGQuote v5.5 - Copyright (C) 1993-1995                                     14
  729. ──────────────────────────────────────────────────────────────────────────────
  730.  
  731.                           Future versions of TGQuote
  732.                           ──────────────────────────
  733.  
  734. You never know what may appear in the next version of TGQuote.  Who knows?!?
  735. We know we don't - we're getting ideas all the time!  We know we promised
  736. several features in this version of TGQuote.  Many of those features made it
  737. in, others didn't.  For example, instead of expanding the RIP capabilities of
  738. the program, RIP was completely removed.  Depending on the responses we get
  739. from users, we may add it back.   So...  Who knows?  RIP capabilities may be
  740. a future feature again. :)
  741.  
  742. We're hoping to partially re-write RemoteQuote to incorporate a new door
  743. library.  This will allow us to put the existing REMOTE.CFG information into
  744. the QUOTE.INI file.
  745.  
  746.                             Contacting the Authors
  747.                             ──────────────────────
  748.  
  749. There are several ways to get in contact with the authors.  If you have an
  750. idea, recommendation, bug report, or just want to say "Hi," here are their
  751. addresses:
  752.  
  753.        Mark Radabaugh                        Todd Hendricks
  754.        221 E. Wrightwood Avenue              353 Soiux Lane
  755.        Glendale Heights, IL 60139-2626       Carol Stream, IL 60188-1519
  756.        BBS: (708) TMP-DOWN                   BBS: (708) 653-0376
  757.        Internet: spock@gregdoor.chigate.com  Internet: ev@mcs.net
  758.  
  759. Also, you may get in contact with Mark Radabaugh via the Telegard Support
  760. Conference carried via Fidonet.  You may also find him on Telegard's Alpha
  761. Site, Lighthouse BBS at (219) 864-1066.
  762.  
  763.  
  764. TGQuote v5.5 - Copyright (C) 1993-1995                                     15
  765. ──────────────────────────────────────────────────────────────────────────────
  766.  
  767.                                   Revision History
  768.                                   ────────────────
  769.  
  770. 1.0     02-09-1993      First public release of TGQuote.
  771.  
  772. 1.1     02-12-1993      Fixed a minor bug where TGQuote was not looking for
  773.                         the file SAYINGS.QTS properly.  See Bug Reports
  774.                         section below.  - FIXED -
  775.  
  776. 2.0     02-17-1993      Added the ability to do color by using the Telegard
  777.                         color codes.  This version also allows the ability to
  778.                         add the authors.  Also released AddQuote, a program
  779.                         that allows the user to add quotes without the use
  780.                         of a text editor.  Also incorporated a new layout.
  781.  
  782. 3.0     03-13-1993      More flexibility added.  TGQuote now allows you to
  783.                         change the header, color, and the author field.  Also
  784.                         integrated in this version is the ability to do a 4
  785.                         line quote.  Also released SetQuote, a program that
  786.                         allows the user to make changes to the setup of
  787.                         TGQuote with ease.
  788.  
  789. 3.1     03-16-1993      Fixed a minor bug where SetQuote was not saving some
  790.                         of the fields correctly.  See Bug Reports section
  791.                         below.  - FIXED -
  792.  
  793. 3.5     04-18-1993      Much more flexibility added.  TGQuote now has three
  794.                         layouts to choose from instead of one.  This release
  795.                         welcomes the return of the box layout.  TGQuote can
  796.                         also randomly select between the three layouts.  Also,
  797.                         AddQuote is a little more informative when editing
  798.                         quotes.  It now displays the bad quote on the bottom
  799.                         of the screen when correcting it.
  800.  
  801. 3.6     04-26-1993      Fixed a minor bug in AddQuote.  When entering many
  802.                         quotes without exiting the program, sometimes AddQuote
  803.                         would do one of two things:  1) It would not let you
  804.                         enter all the lines to a quote; or 2) It would not
  805.                         store the quote properly.  Sometimes it even did both!
  806.                         See Bug Reports section below.  - FIXED -
  807.  
  808.                         Also, added some minor features to TGQuote that were
  809.                         intended to be included in the 3.5 release, but were
  810.                         somehow missed.  See Bug Reports section below.
  811.                         - ADDED -
  812.  
  813. 4.0     07-03-1993      Major upgrade.  This version now allows the user to
  814.                         manually select a quote, generate a text only file,
  815.                         edit a quote, print a quote, use different quote files,
  816.                         run AddQuote remotely, and much more.  This version
  817.                         also has many more styles for the layouts, and includes
  818.                         the ability to do ANSI.
  819.  
  820. 4.1     07-17-1993      Fixed many minor bugs within the program.  When
  821.                         entering an option in manual mode of TGQuote, if the
  822.                         option was not listed as a valid option, TGQuote would
  823.                         do something very weird.  Many other bugs were fixed.
  824.                         See Bug Reports section below.  - FIXED -
  825.  
  826. TGQuote v5.5 - Copyright (C) 1993-1995                                     16
  827. ──────────────────────────────────────────────────────────────────────────────
  828.  
  829. 4.2     08-23-1993      Fixed several bugs in the remote mode of AddQuote.
  830.                         TGQuote will now work properly when used with the
  831.                         included ADDQUOTE.BAT file, and X-Shell.  Please read
  832.                         the READNOW.TXT file contained in this archive for
  833.                         examples on how to setup your BBS to use this
  834.                         feature.  See Bug Reports section below.  - FIXED -
  835.  
  836. 4.5     02-01-1994      Several changes and additions.  SetQuote, and AddQuote
  837.                         re-written from the ground up.  The remote mode of
  838.                         AddQuote was completely re-written, and renamed to
  839.                         RemoteQuote.  More layout styles added, along with the
  840.                         ability to add an "author note."  Maximum number of
  841.                         lines allowed in a quote raised to 10.  New coding
  842.                         used in several places.  RIP graphics capability
  843.                         added.  Many other changes and additions.  Please read
  844.                         the WHATS.NEW file contained in this archive for a
  845.                         list of what has been added/changed for this version.
  846.  
  847. 5.0     06-21-1994      Several changes and additions.  Colors for RIP
  848.                         graphics are now the same as those for ANSI.  TGQuote
  849.                         must now be registered.  A feature to design a custom
  850.                         layout has been added for ANSI users; and a feature
  851.                         to import an ANSI or RIP file.  The .QTS files had a
  852.                         minor structure change, and can be modified to the
  853.                         5.0 format with CONVERT.EXE.  EditQuote has returned,
  854.                         although the move feature has yet been included again.
  855.                         Many other changes and additions.  Please read the
  856.                         WHATS.NEW file contained in this archive for a list
  857.                         of what has been added/changed for this version.
  858.  
  859. 5.5     12-07-1995      Completely re-written code.  Config file completely
  860.                         re-structured.  SetQuote is now a seperate program
  861.                         and has been re-designed completely.  New registration
  862.                         routines.  New quote length.  Duplicate quote checker.
  863.                         Extended quote information editor.  New "no-border"
  864.                         layout.  Can now place special flags in header.
  865.                         Multi-node capability added.  New interface used.  RIP
  866.                         capabilities removed.
  867.                         
  868.  
  869. TGQuote v5.5 - Copyright (C) 1993-1995                                     17
  870. ──────────────────────────────────────────────────────────────────────────────
  871.  
  872.                                    Bug Reports
  873.                                    ───────────
  874.  
  875. - 1.1 -
  876.  
  877. Thanks to Scott Raymond of Shadowdale BBS (718)-934-1843 for reporting a bug
  878. in TGQuote where it improperly searched for the SAYINGS.QTS file.  TGQuote was
  879. constantly looking for the file in a set location, instead of looking for it
  880. in the directory set in the data file.  - FIXED -
  881.  
  882. - 3.1 -
  883.  
  884. Thanks to The General of the former Reconstruction BBS for reporting a bug in
  885. SetQuote version 1.0.  When asking about the author field, if you used any
  886. lowercase letters, SetQuote would save it as a lowercased letter.  Therefore,
  887. TGQuote would not process the information properly.  Due to this bug,
  888. SetQuote will now display and save the Path, Filename and Author fields in
  889. uppercase letters.  - FIXED -
  890.  
  891. Version numbers in all programs have been changed and are now the same for
  892. continuity purposes.  This is to help alleviate any confusion you may have.
  893.  
  894. - 3.6 -
  895.  
  896. Thanks to The General of the former Reconstruction BBS for reporting a bug in
  897. AddQuote version 3.5.  If you were to enter several quotes without exiting
  898. the program, sometimes AddQuote would not let you enter up to four lines in a
  899. quote.  Sometimes, it wouldn't store the quotes correctly.  Every once in a
  900. while it would do both!  - FIXED -
  901.  
  902. TGQuote will now give you an error message if it can't find SAYINGS.QTS or
  903. QUOTE.DAT.  This minor addition was intended to be included in the 3.5 release,
  904. but was missed.  This will keep TGQuote from giving you a run-time error
  905. every time it couldn't find the file.  - ADDED -
  906.  
  907. - 4.1 -
  908.  
  909. Thanks to Brian Madison of the former Galaxy BBS for reporting a bug in
  910. TGQuote 4.0.  When using ANSI, TGQuote would not return back to white on
  911. black colors.  Instead it would remain on the colors you selected for the
  912. background (black on whatever).  - FIXED -
  913.  
  914. I noticed another bug while using TGQuote in manual mode.  If you enter an
  915. invalid option at the "Select Option" area, the program would give a run-time
  916. error, and then proceed to overwrite your "LOGONx.MSG" file.  To prevent this,
  917. if you now enter an invalid option, the program will sound a beep, and return
  918. you to the option.  - FIXED -
  919.  
  920. Also, in manual mode of TGQuote, EditQuote and PrintQuote, a help option has
  921. been added to inform you of each option action.  - ADDED -
  922.  
  923. - 4.2 -
  924.  
  925. While doing some extensive testing of TGQuote, I noticed a few small bugs in
  926. the program concerning the remote mode of AddQuote.  Whenever you tried to
  927. run AddQuote remotely, if it could not find your QUOTE.DAT file, the program
  928. would panic and report a run-time error.  The problem was that it looked in
  929. the current directory for the file, (which could very well have been your BBS
  930. directory!) and didn't see it.  This problem has been fixed by adding a
  931. simple line to your AUTOEXEC.BAT file.  - FIXED -
  932.  
  933.  
  934. TGQuote v5.5 - Copyright (C) 1993-1995                                     18
  935. ──────────────────────────────────────────────────────────────────────────────
  936.  
  937. I also added a feature where TGQuote will "re-execute" itself, in a limited
  938. fashion, to generate the quote.  This removed the need to re-run the program.
  939. While doing the self run, TGQuote will display a message stating it is
  940. generating the quote.  - ADDED -
  941.  
  942. NOTE:  Special thanks go out to Sam Bergen and Stuart Mackey for help with
  943. extensive testing of this feature.
  944.  
  945.                                Error Code List
  946.                                ───────────────
  947.  
  948. This is a list of possible system error codes that TGQuote may generate:
  949.  
  950.    2    Syntax error
  951.    4    Out of DATA
  952.    5    Illegal function call
  953.    6    Overflow
  954.    7    Out of memory
  955.    9    Subscript out of range
  956.    11   Division by zero
  957.    13   TYPE mismatch
  958.    14   Out of string space
  959.    24   Device timeout
  960.    25   Device fault
  961.    27   Out of paper
  962.    52   Bad file name or number
  963.    53   File NOT found
  964.    55   File already open
  965.    57   Device I/O error
  966.    58   File already exists
  967.    61   Disk full
  968.    62   Input past end of file
  969.    63   Bad record number
  970.    64   Bad file name
  971.    67   Too many files
  972.    68   Device unavailable
  973.    71   Disk NOT ready
  974.    74   Can't rename with different drive
  975.    75   Path/File access error
  976.    76   Path NOT found
  977.  
  978. If TGQuote encounters an error, it will do a screen "dump" to a file called
  979. "ERROR.LOG," which shows the cursor position at the time of the error, and
  980. other crucial information.  TGQuote will then stop executing, and drop to
  981. DOS.  If you encounter an error, *PLEASE* report the problem to us, and send
  982. a copy of your ERROR.LOG file.  It could be as simple as not being able to
  983. find a file, to a potential bug in the program.  You may occasionally delete
  984. the ERROR.LOG file without harm to the program.
  985.  
  986.  
  987. TGQuote v5.5 - Copyright (C) 1993-1995                                     19
  988. ──────────────────────────────────────────────────────────────────────────────
  989.  
  990. Note from the authors:
  991.  
  992. Well, here we are again! <grin>  To begin with, I'd like to apologize for the
  993. *LATE* release date of TGQuote.  Halfway through the project, both we realized
  994. the re-write wasn't going in the direction we wanted it to.  So, we sat down
  995. and began re-writing the code from scratch for a second time!  (So actually,
  996. you're running the re-write of the re-write!)
  997.  
  998. This version marks some major changes in the operation of TGQuote.  When
  999. version 5.0 was released in June of 1994, we made a decision to re-write the
  1000. code from the ground up.  This was mainly done for two reasons: 1) On many
  1001. systems, the old code wouldn't work - we never really found out why; 2) It was
  1002. really becoming hard to add new features - the old code was filled with
  1003. reduntant code, and it jumped around all over the place.  So...  As promised,
  1004. v5.5 contains all new code.  While we re-wrote the code, we added new
  1005. features, and redesigned others.  TGQuote now operates a lot more logically.
  1006. While we were at it, we kept in mind the need to update the software on a
  1007. regular basis - therefore, we designed the logic and structure of the code in
  1008. a suitable manner.  We hope you enjoy the "new" TGQuote, just as much as we
  1009. enjoyed writing it.  Finally, we want to thank you for choosing TGQuote, and
  1010. giving us the opportunity to write it.
  1011.                                                       
  1012.                                                       - Mark Radbaugh, and
  1013.                                                         Todd Hendricks
  1014.                                                         Authors
  1015.  
  1016.